My Website

*****************************************
* GavsWorld Website Software / Template *
*****************************************
* Change Log *
**************
2024-04-05 : version 2.23.3
Enhancements:
   None
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   Duplicate rss.php in "self" link for RSS feed, similar duiplicate of
   "atom.php" in "self" link for ATOM feed.
************************
2021-12-29 : version 2.23.2
Enhancements:
   None
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   The permalinks for the news feed only worked if the website was in the
   document root. Now takes into account the path.
************************
2021-10-23 : version 2.23.1
Enhancements:
   None
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   Not really a fix, but the W3C has recently deprecated the media
   "projection" for style sheets. This was in the XHTML header data
   that's generated from index.php
************************
2020-06-07 : version 2.23.0
Enhancements:
   Added ability to insert html pages from html pages with a special HTML
   comment. Similarly, the ability to include PHP files and call PHP functions
   from similar HTML comments.
   For example:
     <!-- insert user_includes/A_Common_File.html -->
     <!-- php_file ./user_includes/a_php_file.php -->
     <!-- php_function a_user_function(1,4) -->
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   None
************************
2020-01-04 : version 2.22.0
Enhancements:
   Changed the method of page stat file locking: now uses flock to determine
   exclusive lock on the actual file instead of creating a lock file, which
   was causing issues while testing my cluster-pi web server.
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   None
************************
2016-01-29 : version 2.21.2
Enhancements:
   None
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   Not really a fix, but the source of the cookie consent form, "silktide"
   moved the location of the actual javascript. So a simple change to point
   to the new location.
************************
2015-09-15 : version 2.21.1
Enhancements:
1. Added theme choice to Cookie Consent form
New Setup Variables (see <setup-sample.php> for details):
1. $my_cookie_theme
Bug Fixes:
   None
************************
2015-09-14 : version 2.21.0
Enhancements:
1. Added a Cookie Consent bit of Javascript courtesy of Silktide -
   http://silktide.com/cookieconsent
2. Added a "Follow Me" social bookmarking category that uses the same icons
   as the page social bookmarks.
3. Added a "viewport" to the page as the 1st stage in making the website
   more mobile friendly.
New Setup Variables (see <setup-sample.php> for details):
1. $my_cookie_consent
2. $my_cookie_message
3. $my_cookie_dismiss
4. $my_cookie_learnmore
5. $my_cookie_link
6. $my_social_follow_title
7. $my_social_follow_me[]
Bug Fixes:
1. Not really a bug fix, but removed stale social bookmark icons.
************************
2012-12-01 : version 2.20.2
Enhancements:
   None
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
1. Fixed social bookmark links to pages with spaces (etc) in the names by
   calling urlencode().
************************
2012-05-05 : version 2.20.1
Enhancements:
   None
New Setup Variables (see <setup-sample.php> for details):
1. $my_paypal_donate
2. $my_paypal_donate_header
3. $my_paypal_donate_button_id
4. $my_paypal_donate_image
5. $my_feed_path
Bug Fixes:
1. Not really a bug fix, but looks like I forgot to add the appropriate
   variables to setup_sample.php for the last release!
************************
2011-09-25 : version 2.20.0
Enhancements:
1. Added the option of a PayPal donate button above the first category heading
   with a few more variables to configure it. The heading used will be a link
   to a page of the same name, so there needs to be one in /hidden_pages.
2. Moved the "Contact" captcha to below the comment field and changed
   "question" to "captcha".
3. Improved the page title for:
     "News.php"
     "Image.php"
     "Text Viewer.php"
     "Latest Updates.php"
     "Website Stats.php"
   All done with a new include file "/includes/meta_title.php" to check for
   the page call before the page is displayed. Also allows a user definable
   file to perform similar tasks for their own pages.
4. Removed meta tag "description" as it was exactly the same content as the
   title, but was throwing up HTML warnings with Google Web Stats.
5. Improved the advertising of news feeds, since some servers present the
   username of the install which may not be desirable. User can now fix
   how the feeds are advertised.
6. Allow the user to chose their own captcha question / answers by creating
   a file called ./user_includes/botty_q_and_a.php where they are listed.
7. Now filters out any dodgy re-direct requests that have come through as
   %2520 for a space in the URL... just in case the .htaccess rules aren't
   working properly.
New Setup Variables (see <setup-sample.php> for details):
1. $my_paypal_donate
2. $my_paypal_donate_header
3. $my_paypal_donate_button_id
4. $my_paypal_donate_image
5. $my_feed_path
Bug Fixes:
   None
************************
2011-03-11 : version 2.19.0
Any users upgrading will need to update their style sheets - see enhancement 1.
Enhancements:
1. Added "permalink" links to each news item, both on the News feed and on
   the Home page page. Requires two more style sheet <div> definitions called
   perma_link_h3 (for News feed) and perma_link_h4 (for Home page). It will
   sit under the heading using the default style sheets.
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   None
************************
2011-02-19 : version 2.18.0
Enhancements:
1. Added the facility for a photo album without all of the comments:
   just displays the thumbnails in a grid.
2. Added the "top" image of "blue" and "wide_blue" style sheets which I'd
   somehow missed in 2.17.0! Small tweek to the style sheets to make it
   work too.
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
   None (unless you call #2 above a bug).
************************
2011-01-11 : version 2.17.0
Enhancements:
1. Added option to disable displaying the page list.
2. Added "top" and "bottom" <div>s to the output.
New Setup Variables (see <setup-sample.php> for details):
1. $my_disable_page_list
Bug Fixes:
1. Oops - accidentally deleted a line from <setup.php> to set a "cookie"
   for the locking of the stats files! Fixed now.
************************
2010-11-03 : version 2.16.0
Enhancements:
1. Atom and RSS feeds now provide a permalink to the individual news item
   instead of just the year, month and day (there may be multiple items in
   a particular day).
2. RSS feed now displays more than just the first 80 characters, i.e. the
   whole article.
New Setup Variables (see <setup-sample.php> for details):
   None
Bug Fixes:
1. XHTML validation was failing on "Latest Updates" page if there were no
   updates as the table was being rendered without any content.
2. Atom and RSS feeds tweeked such that the getdate() function is called
   after the timzone is set, not before.
3. A lock file is now created when updating the page stats to save the stats
   being cleared during simultaneous page requests.
************************
2010-08-11 : version 2.15.0
Enhancements:
1. Pages that have been numerically sorted can now be requested without their
   number prefix. This applies to sub-pages too! Because of this, the category
   and page lists have their sorting numbers removed when linking too.
2. Added the facility to display a Google site verification tag in the page
   meta data.
New Setup Variables (see <setup-sample.php> for details):
   $my_google_site_verification_code
Bug Fixes:
   None.
************************
2010-03-30 : version 2.14.1
Enhancements:
   None.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Fixed a bug in the atom and rss feed validators: I'd changed the value of a
   variable for displaying the social bookmarks, but forgot it was used else
   where in the code. Thanks to Bruce Levick for spotting another bug!
************************
2010-03-25 : version 2.14.0
Any users upgrading may want to update their style sheets, although only if
they wish to take advantage - see enhancement 1.
Enhancements:
1. Added more <div>s to the style sheet to allow the category headings and
   all related pages to be played with as a block. Also one for the search.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Added a Windows bug work-a-round to get e-mail to send when running on a
   Windows server (Contact.php and Survey.php).
2. Not really a bug, but by default, the example e-mail re-direct is now
   commented out since some users still can't RTFM!
3. The meta tag in the page header now only displays the year once if the
   copyright start and current year are the same (did a similar fix for the
   page footer back in v2.10.0.
4. Fixed the social bookmarks that weren't passing specific page parameters
   to the bookmarking site - although it will still come down to the actual
   bookmarking site whether it considers the extra parameters to be junk.
************************
2010-03-04 : version 2.13.1
Any users upgrading will have to update their style sheets as the <hr> tag
has been moved - see enhancement 1.
Enhancements:
1. Moved the <hr> style tag from <photo_albums.css> into all of the individual
   style sheets allowing it to be customised on a style basis.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. The search function now checks whether the News feed is present before
   attempting to search through it (thanks to Jim Leach for finding this).
************************
2010-02-19 : version 2.13.0
Enhancements:
1. Added social bookmarking icons that appear on each page.
2. Added the default_timezone since PHP >= 5.1 wants this for any time
   function calls.
3. Added the ability to hide the website title on the page - usefull if you
   have the name already on the background image.
New Setup Variables (see <setup-sample.php> for details):
   $my_timezone
   $my_enable_social_bookmarking
   $my_main_title_hide
Bug Fixes:
1. Stopped a filemtime call on Home.html if it did not exist under the
   condition of there being a Home.php, News.php and a valid news feed.
************************
2010-01-23 : version 2.12.0
Enhancements:
1. Added last access date / time to the Website Stats page
2. Enhanced the "Contact" page to allow a fixed subject matter and name to
   be passed into the page. Very useful if you want to re-direct a message
   to a particular address as this function goes by the subject line.
3. Added the facility to have simple text files as pages.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
   None.
************************
2009-12-03 : version 2.11.0
Enhancements:
1. Added a simple photo album viewer which scans a specified directory
   and displays all photos. Each "album" requires a PHP file to point
   to it and define photo titles / comments. See example in template.
2. Added a simple search which searches all pages / news feeds (not hidden
   pages though - there must be a reason that they are hidden!). Note that
   this is purely a text match. New variable must be added to <setup.php> to
   enable this feature.
New Setup Variables (see <setup-sample.php> for details):
   $my_enable_search
   $my_extra_style_sheet[] (now used by default, not commented out)
Bug Fixes:
1. Discovered that PHP v4 doesn't like strrpos with a "needle" being more
   than one character. So, "Latest Updates" and "Website Stats" didn't
   show any files ending in html (this was code introduced to look for
   link files).
************************
2009-11-04 : version 2.10.2
Oh no! A second bug release in a week. Mind you ... I knew about this
last week, but forgot to fix it - D'Oh!
Enhancements:
   None.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Didn't check the top of the page when I tested the code to hide the
   copyright information: the name was being displayed at the top of the
   actual page since the header got slightly corrupted due to having a
   missing meta open tag.
************************
2009-11-01 : version 2.10.1
Enhancements:
   None.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Fixed a couple of bugs on "Latest Updates" and "Website Stats" pages that
   crept in after the link files were added in version 2.10.0. Basically they
   are non-existant pages, so should not be shown.
************************
2009-10-22 : version 2.10.0
Enhancements:
1. Added a new page called "Website Stats" which shows latest update times
   and page counter hits, with a grand total at the bottom. Displays pages
   images and news.
2. Added the facility to have external website links appear as category
   headings or under category headings and not just in the website lists.
   These will open in the same window as it's anticipated that they will be
   for sites on the same server but outwith this software's control.
3. Allows copyright information to not be displayed by commenting the
   variable $my_copyright_start in <setup.php>
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Only displays the year once if $my_copyright_start = the current year
************************
2009-05-26 : version 2.9.0
Enhancements:
1. Improved the RSS and Atom page rendering: Atom now displays entire news
   items in XHTML. Both now present correct MIME type via header() call.
2. Added CSS sheets for printing - totally forgot about that one!
3. Added "Latest Updates" page to show list of latest page updates together
   with their modification time.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
   None.
************************
2009-04-06 : version 2.8.0
Any users upgrading will have to update their style sheets as a new <div>
has been added (see enhancement 4).
Enhancements:
1. Changed the "you're a SPAMBOT" section of <Contact.php> as it appears that
   some people can't figure out to just go back and answer the question
   correctly!
2. Added <Survey.php> which allows you to construct simple forms that generate
   e-mails.
3. Added facility for a custom "Page Not Found" error page which lives in
   ./hidden_pages
4. Put the "(* updated in last 14 days)" text into its own div in the page
   list div. This allows the font to be changed from the style sheet.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. A couple of formatting errors in Contact.php fixed.
************************
2009-03-05 : version 2.7.0
Enhancements:
1. Added the facility to support "favicon.ico" which *must* live inside the
   ./images directory.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Discovered that some systems were reading the file change time wrong. All
   related time function calls changed from filectime to filemtime (file
   modification time).
************************
2009-02-20 : version 2.6.0
Any users upgrading will have to update their style sheets as all validation
icons required a new <div> to fit them (see enhancement 1). Page stats moved
into same <div>.
Also, the ./images directory has been tidied up - validation icons and style
sheet images have been put into sub-directories.
Enhancements:
1. Added a news feed in RSS 2.0 and Atom 1.0 formats with new validation
   icons to go with them. Icons moved out of page lists into new division
    defined in style sheet.
2. News page name can now be changed to any name, "Blog" for example. New
    variable in <setup.php>.
New Setup Variables (see <setup-sample.php> for details):
1. $my_news_page
Bug Fixes:
1. Fixed array lookups if arrays are empty on the very rare occasion that
   the software installed and no pages are present *at all*
2. Stopped page / image calls outside of their designated directories, i.e.
   if someone specified a page / image with "../../another_file"
************************
2009-02-10 : version 2.5.0
Enhancements:
1. Changed how the software adds "IE Fixes" code into the generated XHTML.
   This involves looking for specific file names, e.g. lt_7-pencils.css
   which will contain fixes for IE less than version 7. See the website
   template for a full description. Any user upgrading to this version
   *WILL* have to re-name their IE_Fixes files.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
   None.
************************
2009-02-02 : version 2.4.0
Enhancements:
1. Added the ability to have IE_fixes style sheets for any "extra" style
   sheets. These must live in ./style_sheets/extra/IE_fixes
2. Allowed the default page to be something other than "Home" - see new
   variable $my_default_home_page in <setup.php>.
New Setup Variables (see <setup-sample.php> for details):
1. $my_default_home_page
2. $my_disable_w3c_validation
Bug Fixes:
   None.
************************
2009-02-01 : version 2.3.1
Enhancements:
   None.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Discovered that if a page or sub-page is purely a number, the function
   to display the category was just displaying a blank line (missing check
   chen checking for leading numbers for numerical sorting).
************************
2009-01-29 : version 2.3.0
Enhancements:
1. Cosmetic change to the "page updated" flags: now if a sub-page has been
   modified, but the parent page has not, the * is shown as (*).
2. Passed the definition for the initial page view counter value into the
   user's control - $my_page_count_start now in <setup.php>
New Setup Variables (see <setup-sample.php> for details):
1. $my_page_count_start
Bug Fixes:
   None.
************************
2009-01-26 : version 2.2.0
Enhancements:
1. Enabled page stats for <News.php> - "last update" based upon the top news
   article and a count based on any time the page is called, i.e. irrelevant
   of news_year and news_month.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
1. Fixed the "page updated" feature - when making the new <Home.php> it was
   looking for <Home.php> time stamp instead of <Home.php> / latest News item.
************************
2009-01-23 : version 2.1.0
Enhancements:
1. Added <Home.php> which displays <Home.html> and then displays the latest
   News item.
New Setup Variables (see <setup-sample.php> for details):
   None.
Bug Fixes:
   None.
************************
2009-01-15 : version 2.0.0
Enhancements:
1. Optional page stats can be displayed at the bottom of the page body with
   date modification time and a hit counter. New variables in <setup.php> to
   control this. A wee cheat on creating the initial stats files though -
   a random number between 10 and 30 is chosen ... but you'd never know ;-)
   The stats are recorded regardless if they are displayed, so you have the
   option at a later date (with the actual numbers), if they are not
   displayed initially.
2. Added the ability to include extra style sheets which can be defined in
   <setup.php>. They must live in the ./style_sheets/extra directory.
3. Added the ability to do a complete change of style sheet, not just wide
   or narrow. The order of precedence ("a" is highest level) for final style
   sheet selected is as follows:
      a) $my_force_css_width
      b) $my_force_css
      c) Cookie style sheet (if allowable)
      d) $my_default_page_style
4. Tidied up the <title> and <meta description> by removing leading numbers
   in the case of numerically sorted pages.
5. Added a Text Viewer page for displaying text files in the standard layout.
   There is an option to display as code which adds line numbers.
6. Managed to get the pages displaying better in IE 6 and below.
7. Constructed a more informative demo website to explain the workings of the
   software.
8. Contact form now accepts pre-defined subjects (if defined in <setup.php>)
   and also has the ability to re-direct e-mails for a particular subject to
   a different e-mail address (again defined in <setup.php>).
9. Changing the name of the "Contact" page now updates any links in the pages,
   assuming you change the variable in <setup.php>
New Setup Variables (see <setup-sample.php> for details):
1. $my_contact_page
2. $my_contact_subject[]
3. $my_contact_redirect
4. $my_stats_active
5. $my_stats_date_format
6. $my_extra_style_sheet[]
7. $my_force_css[]
Bug Fixes:
1. HTML pages displayed will no longer display empty lines from the file.
2. The "acknowledgement screens for the "Contact Me" were hard coded to
   display "Gavin" on the page. A couple of string replacements that I missed
   when making the software generic. It will use $my_company_name if it is
   defined in <setup.php> like the rest of the page does.Thanks to Bruce
   Levick for spotting this one too.
************************
2009-01-05 : version 1.4
Enhancements:
1. Version numbers added to *all* <*.php> files (in the package) with a
   sanity check of them performed at the end of <index.php>. This should
   ensure compatibility in case anyone upgrades software and forgets a file
   or two. Obviously this will only work from this version onwards and if
   they use the new <index.php>.
New Setup Variables (see <setup-sample.php> for details):
1. $file_version["setup.php"]
Bug Fixes:
1. <Image.php> didn't have a couple of \n so the XHTML looked messy.
2. Added an extra parameter to mail() in <Contact Me.php> as some servers
   have been set up to require the "envelope sender address" when using
   sendmail. Thanks to Bruce Levick for spotting that one.
3. Removed unnecessary XHTML comments from <News.php>.
4. Searching a NULL "haystack" in <find_all_pages.php> when looking for
   hierarchical updates if the first page found had not been updated. So,
   set the starting gambit from "" to " "
************************
2008-12-26 : version 1.3
Enhancements:
1. Now every page will show if it's been updated or not. As a result, there
   has been a slight re-write of the category scanning functions etc. It'll
   actually be a tad quicker now as the scanning is only done once for - the
   <Site Map.php> used to call a re-scan.
New Setup Variables (see <setup-sample.php> for details):
1. $my_update_redirect[]
Bug Fixes:
   None.
************************
2008-12-21 : version 1.2
Enhancements:
1. Added <Site Map.php> into the <.hidden_pages> and a link in the menu to it.
   When called it'll display all available pages in the main panel.
New Setup Variables (see <setup-sample.php> for details):
1. $my_image_width["pencils"]
2. $my_image_width["wide_pencils"]
3. $my_image_width["blue"]
4. $my_image_width["wide_blue"]
Bug Fixes:
1. Fixed the image width in <Image.php> for displaying. The size was set for
   "blue" and "wide_blue" style sheets, however "pencils" and "wide_pencils"
   are different. Widths now set in <setup.php>
2. Fixed a horrible looking \n in the "News ( Updated )" line. Now on 1 line
   in the XHTML source.
************************
2008-12-18 : Version 1.1
Enhancements:
1. News feed will show ( Updated ) if the latest news item is newer that the
   number of days defined by $my_news_old_after in <setup.php>
New Setup Variables (see <setup-sample.php> for details):
1. $my_news_old_after
Bug Fixes:
1. If a cookie had been sent before $my_allow_style_change was set to FALSE,
   the cookie would still have been read and the page style set to that value.
************************
2008-12-13 : Version 1.0
Initial release to the world, based upon www.gavsworld.net